PC Graphics Unleashed

home *** CD-ROM | disk | FTP | other *** search

/ PC Graphics Unleashed / PC Graphics Unleashed.iso / ch01 / display.doc < prev next >

Wrap

Text File | 1994-07-29 | 23.6 KB | 673 lines

DDDD III SSSS PPPP LL AAAAA YY YY DDDDD III SSSSSS PPPPPP LL AAAAAAAAA YY YY DD DD III SSS PP PP LL AA AA YY YY DD DD III SSSSS PPPPPP LL AA AA YYYY DD DD III SSSSS PPPP LL AAAAAAAAA YY DD DD III SSS PP LL AA AA YY DDDDD III SSSSSS PP LL AA AA YY DDDD III SSSS PP LLLLLLLL AA AA YY Program written by Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw) Document written by Jih-Shin Ho (u7711501@bicmos.ee.nctu.edu.tw) and Oliver Weyand (chbrin3@nyx.uni-konstanz.de) Document modified by Ben Jos Walbeehm (Walbeehm@fsw.ruu.nl) !!! You may distribute this program freely for non-commercial use. !!! !!! There is no warranty. The author is not responsible for any !!! !!! damage caused by this program. !!! (1) Introduction: This program lets you READ, WRITE and DISPLAY images/movies with different formats. It lets you do some special effects (rotation, dithering, ...) on images as well. Features: Includes simple file management system. Supports 'slide show', 'batch conversion', 'contact sheet making', 'image preview'. There is NO LIMIT on image size. This program supports 8, 15, 16, 24 bits display. Supports movie files (DL, FLI/FLC, RAW, MPEG, AVI, GL, IFF/ANIM). Supports FLC making. Supports mouse. The official site is NCTUCCCA.edu.tw:/PC/graphics/disp. The IP address is 140.111.1.10 or 192.83.166.10 (2) Command Line Switches: DISPLAY understands several command-line parameters. Some of them are useful for setting up your preferred configuration or overwriting config.dis options. Others are for command-line processing. Usage : display [-d|--display initial_display_type] [-s|--sort sort_method] [-f config_file] [-a] [-n l|g] [--help|-?] [--direct|-t working_directory] [--mask|-m filename_mask] [--width|-w image_width] [--height|-h image_height] [image_file(s) | @response_file] For command-line batch conversion : display (--batch | -b) output_format [--bw|--grey|--color|--true] + [--dialog | -g] [--report|-r report_file] (file | file dir | file_in file_out | files dir) For command-line slide show : display [--slide|-l] [--noask|-k] (image_files | @response_file) + For command-line contact sheet generation : + display (--sheet|-e) batch_conatc_sheet_script [--report|-r report_file] Display type: 8 (SVGA, default), 15, 16 (HiColor), 24 (TrueColor) Sort method: 'name', 'ext' -a: Always set to highest display type -f: Read user specified config file only. -n: Do not read Local or Global config file. -w & -h: for image format without information header(YUV,RGB,GREY). output_format : Standard extensions. Like gif, bmp ... (see section (7)) filename mask : separated by ';'. The default color type for batch conversion is Full color (8 bits). Please read NEW-FAQ for the information about batch contact sheet. (3) Function Keys: Escape : Abort function and return. RETURN : Select. In menu selection : ESCAPE,F10 : Quit program (prompted). F1 : Show READ.ME. CTRL-F1 : Show user-defined help file. F9 : For those who cannot remember all commands of DISPLAY. F2 : Change disk drive. CTRL-A -- CTRL-Z : change disk drive. F3 : Change filename masks. (Separated by ';') (See match.doc) F4 : Change parameters. F5 : Some effects on pictures, e.g. flip, rotate ... F7 : Make Directory. t,T : Tag file. (Untags tagged files) + : Tag a group of files. (See match.doc) ALT-T : Tag all files. u,U : Untag file. - : Untag a group of files. (See match.doc) ALT-U : Untag all files. Ins : Change display type (8, 15, 16, 24 bits). F6,m,M : Move file(s). ALT-M : Move single file (ignores tags). F8,d,D : Delete file(s). ALT-D : Delete single file (ignores tags). r,R : Rename file. c,C : Copy File(s). ALT-C : Copy single file (ignore tags). z,Z : Display first 10 bytes in Ascii, Hex and Dec modes. f,F : Display disk free space. Page Up/Down : Move one page. TAB : In mode selection screen : Change process target. In file selection screen : Show previously loaded image. w,W : Write previously loaded image. Left/Right arrow: Change display type In 'screen' & 'effects' menu. s,S : Slide Show (shows tagged files). ESCAPE to terminate. b,B : Batch conversion (converts tagged files to a single format). You can perform up to 8 special operations. Each is independent of the others. e,E : Contact sheet making. w,W : Wait/Pause in slide show. q,Q : Accumulation color quantization. Finds the best palette set for a group of files. Very useful for producing animation pictures. l,L : List available graphic/text modes. o,O : Display font. ALT-X : Quit program without prompting. ALT-A : Re-read directory. ALT-S : Save config file. 0..9 : SHIFT-A..Z : Jump to first file whose name starts with this character. BACKSPACE : Go up one level in the directory tree. v,V : View text file. x,X : View binary file. p,P : Turn preview on/off. ALT-Z : Shell to DOS. + ALT-E : Edit description entry. (see NEW-FAQ) + ALT-W : Write description entries. (see NEW-FAQ) In graphics mode : RETURN,SPACE,ESCAPE : return to the text mode. '+' : Go to next resolution. '-' : Go to previous resolution. Arrow keys, Home, End, Page Up, Page Down : Scroll image. Home: Left-most. End: Right-most. Page Up: Top of image. Page Down: Bottom of image. CTRL-Arrow keys: Crop image by one line. CTRL-SHIFT-Arrow keys: Big Crop (Controlled by 'big_crop_step'). F1 .. F8 : Gamma correction. F1,F3,F5,F7: decrease Red,Green,Blue,All. F2,F4,F6,F8: increase Red,Green,Blue,All. F9,F10 : Zoom Out/In. In text viewer : F2 : Search string (case-sensitive). F3 : Search string (case-insensitive). In contact sheet preview & Postscript preview : '+' : Increase scaling factor. '-' : Decrease scaling factor. Ins,Del : Fine tune(Inc/Dec) scaling factor. In Slide show : If the delay time is 0, the program will wait until you hit any key (except ESCAPE). 'w' or 'W' to pause, any key to continue. + Up-Arrow : Go back one image. + Note: Reverse slide show is slower. + You must set delay time = 0 to use Up-Arrow. In movie: SPACE : pause playing. If you press 'w' or 'W', the program writes the current frame to a file. After writing, playback pauses at the next frame. ESCAPE : Terminate playing. (4) Mouse Buttons: MIDDLE button and CTRL-RIGHT button always mean ESCAPE. in read/write menu: single-click LEFT or RIGHT button = 'move select bar'. double-click LEFT button = RETURN. double-click RIGHT button = SPACE. CTRL-LEFT button = Tag. in other text menus: RIGHT button means SPACE. single-click LEFT button = 'move select bar'. double-click LEFT button = RETURN. in contact sheet preview: RIGHT = show/hide mouse cursor. LEFT = move an image piece if the mouse cursor is shown, else leave graphics mode. CTRL-LEFT = move contact sheet. in image display screen: RIGHT = show/hide mouse cursor. LEFT = move the image around the screen if the mouse cursor is shown, else leave graphics mode. CTRL-LEFT = move one page. SHIFT-LEFT = show information box. You can move this box around screen by click and drag. ALT-LEFT = define rectangle for cropping. Releasing left button will crop image if ALT key is still pressed, else do nothing. CTRL-ALT-LEFT = toggle showing image coordinates. in mode selection screen: Click LEFT bottom at: 'Imag8' or 'Imag24' : change processing target. '000 x 000 x 000' or '000 x 000' : change display type. '<--' or '|||' : change linking status. In some text regions the mouse cursor will change. Press the LEFT button to accomplish that. (5) Supported Formats: Read: GIF(.gif), Japan MAG(.mag), Japan PIC(.jpc), Sun Raster(.ras), Jpeg(.jpg), XBM(.xbm), Utah RLE(.rle), PBM(.pbm), PGM(.pgm), PPM(.ppm), PM(.pm), PCX(.pcx), Japan MKI(.mki), Tiff(.tif), Targa(.tga), XPM(.xpm), Mac Paint(.mac), GEM/IMG(.img), IFF/ILBM(.iff,.lbm), Windows BMP(.bmp), QRT ray tracing(.qrt), Mac PICT(.pct), VIS(.vis), PDS(.pds), VIKING(.vik), VICAR(.vic), FITS(.fit), Usenix FACE(.fac), IRIS(.sgi), YUV(.yuv), RAW RGB(.rgb), PCPAINT/Pictor(.pic,.clp), RAW GREY(.gry), Photo-CD(.pcd). DL(.dl), FLI(.fli), FLC(.flc), RAW(.raw, produced by DMPEG), MPEG(.mpg), AVI(.avi), GL(.gl). the extensions in () are standard extensions. Write: GIF, Sun Raster, Jpeg, XBM, PBM, PGM, PPM, PM, Tiff, Targa, XPM, Mac Paint, Ascii, Laser Jet, IFF/ILBM, Windows BMP, Mac PICT, VIS, FITS, FACE, PCX, GEM/IMG, IRIS, YUV, RAW RGB, Postscript, RAW GREY. Preview: GIF, Jpeg, Windows BMP, PBM, PGM, PPM, Targa, PCX, Mac Paint, Photo-CD. All Read/Write formats support full color(8 bits), grey scale, b/w dither, and 24 bits image, if allowed for that format. (6) Overview: Initialization steps: Set default display type to highest display type. Find an allowed screen resolution (for .grn video drivers only). Read the configuration file (Global and Local). Global: where DISPLAY.EXE resides. Local: Where you are. Process the command line options (if any). This Program is MEMORY-GREEDY. If you do not have enough memory, its performance is poor. (7) Detail: (written by Oliver Weyand, chbrin3@nyx.uni-konstanz.de) GENERAL RULES This section will describe the menus and options you can choose from. You can read through it or just start the program and play around. When you have a problem you can come back and read the section you need. Most things are self-explanatory. Look for the comments behind a possible command. Also keep an eye at the first and last row of the screen: DISPLAY will tell you in most cases what is going on. There are several fields with a special meaning (i.e. [ Auto Read ]). You can activate them by moving the cursor inside the marks and then click the left mouse button. In any MENU you can call a pull-down-menu by pressing the F9 key or moving the cursor to the top-line and click a button. The different functions can also be selected by using a hot-key. Sometimes DISPLAY will ask you questions. You can answer them with a mouse click or by pressing the first (capital) letter of the answers (Y or y for yes). Allowed operations are shown in white the others in grey (if you use the default colors). ----------------------------------------------------------------------------- THE READ-MENU ----------------------------------------------------------------------------- After starting DISPLAY, you will find yourself in the read-menu. You will see a file list of the directory you started DISPLAY from (or the directory you have specified with the -t command line option). There are six marked fields you can use with the mouse. In the pull-down-menu bar you will find 8 headers with a different number of options. Because all operations are accessible with short-cuts, that's the easiest way to call them. For some operations (e.g. slide show) you have to tag at least one file. For Reading a file (image, movie) simply select one and press RETURN or double click with the left mouse button. Display will autodetect the correct format by itself. If you have problems try using the SPACE-bar or double click with the right mouse button for selecting a format manually. 1. HELP Calling help will load the READ.ME file. It contains help about possible actions and a list of all short-cuts. There is also a description of the meaning of the mouse buttons (be sure to check them out, because they change, depending on the menu you use). 2. FILES You have several options to manipulate files. You can delete, move, copy, rename and view files. The options for shelling to DOS and quiting the program are also located under this header. You can perform the actions on a single file, a group of files, or the file currently under the marker. 3. DIR From inside DISPLAY you can make directories. Another point is rereading the current directory, for updating changes you have written to disk. 4. OPERATION That's the menu with the real highlights of DISPLAY. Here you can choose from the options: slide show, batch conversion, contact sheet, accumulate quantization, and the special effects. Further you can display the fonts comming with DISPLAY, show and write a already loaded image, and unpack gl-files. 5. CHANGE Under this header you will find options to select the image type and graphic resolution (for a list of possible modes for your graphic card take a look at the status menu or type L). Other options are for changing the working-drive and for editing the file mask (see match.doc). 6. TAG Believe it or not this one is for tag and untag files (single, group, all). I think that's all you must know. 7. OPTIONS This menu point is for changing the defaults. Open the submenu and you will see a number of fields, where you can change most parameters that DISPLAY uses. You can activate them just for one run or make them the default by saving a new config.dis. You can work with different configur -ations, when you use different local config.dis files (i.e. make directories for the users of your system, if there is more then one). 8. STATUS Here you can get informations about your graphic card, RAM, disk space, and the formats of your image files. ----------------------------------------------------------------------------- THE WRITE-MENU ----------------------------------------------------------------------------- When you choose an option that will write changes to your disk, you will sometimes enter the write-menu (i.e. moving files). In the write menu you will find other marked fields for use with mouse. Although you will see the same headers in the pop-up-menu, most of the options are disabled. Also the most short-cuts won't help you. I think you will use this menu without problems, because it is very self-explanatory. ----------------------------------------------------------------------------- THE SCREEN-MENU ----------------------------------------------------------------------------- Once you have loaded a picture, you will see the screen-menu (if you don't set the 'auto_display_image' to 1). It has a different look and pop-up-menu structure. If the loaded file is a movie, you will find yourself in another menu, which is optimized for the additional needed options you need to display movies. The marked fields in the screen-menu are for viewing an image in the selected resolution or writing it to file. Further you can go back to the read-menu or exit the program. On the left you see three bigger fields. They are for those of you, who are using a mouse and don't want to use the keyboard for pressing the return, space, or esc keys. The graphic modes you can select from (to show the image) are in white, the others are grey. Pressing F9 again will bring up the headers of the pop-up-menu. These have changed a little, compared to the read/write menu 1. HELP Same as in read/write menu. 2. FILES Only the exit option is still there, for the other things you have to go back to the read/write menu. 3. OPERATION Three options are now in the submenu. You can choose between special effects, display fonts, and change processing target. The last option means to change between palette images (most 8-bit images are of that type) and RGB-pictures (truecolor, highcolor). You can link these to types, so that changes made to one type will also become true for the other (see the file config.dis). 4. OPTIONS Same as in read/write menu except for the preview option. 5. STATUS The possible graphic and text mode are shown here (depends on your hardware and the driver you use). 6. UTIL This one is new in screen-menu. What you find in this submenu are some often used operations from the special effects menu (look there for a description of the comands). ----------------------------------------------------------------------------- SPECIAL-EFFECTS-MENU ----------------------------------------------------------------------------- When you start manipulating your pictures you will at some point look in the special-effects-menu. The different effects are sorted in 6 groups. As mentioned above you can rotate, flip, resize, mix, and convert images. Most often other programs offer only a few operations DISPLAY is able to do. Some other effects DISPLAY performs are otherwise found in professional and expensive graphic packages only! In this chapter you will find the complete list of possible effects with some short comments. The numbers are the same as in DISPLAY. If you want to make some of these effects the defaults for batch conversion please find the [Batch_Convert] section in config.dis and read the comment. Number Operation Comment (if necessary) (01)-(01) Flip Horizontal - (01)-(02) Flip Vertical - (01)-(03) Rotate Clockwise (90) - (01)-(04) Rotate Counter-clockwise (90) - (01)-(05) Rotate/Shear image (any angle) lets you rotate the image any angle you want. If you don't know what shearing means just do it. It's easier to look than to explain. (02)-(01) Resize image ( ->24 ) the resizing operation will promote the image to 24-bit if you smooth it. In the upcoming screen are some more options: You can change the size by pixel, by %, or resize different images to the same size (batch conver- sion) (02)-(02) Auto Crop cuts off "unused" pixel. Better use the online crobbing in graphic mode (Crtl-cursor). Useful for batch conversion (02)-(03) Mix/Concat two images overlay or put together two images with different options (02)-(04) New Dimension Adjust the image dimension. Adding background or cropping if necessary. (03)-(01) Convert to Grayscale - (03)-(02) Do B/W Dither - (03)-(03) Pseudo Color do you like strange effects ? (03)-(04) Color Quantization try FS (Floyd-Steinberg) first (03)-(05) Promote to 24-bits - (04)-(01) Histogram Equalize enhance the contrast. (04)-(02) Smooth/Enhance Images - (04)-(03) Edge Enhancement opposite of smoothing (04)-(04) Negate Image - (04)-(05) Oil paint ever wanted to be a painter ? (04)-(06) Gamma Correction better use F1-F8 in graphic mode. Useful for batch convert (04)-(07) Cheesy Embossing convert color to height-field (04)-(08) Remove unused colors - (04)-(09) Swap R/G/B make some funny images ! (05)-(01) Discard 24-bit image - (05)-(02) Discard 8-bit image - (05)-(03) Push image into stack - (05)-(04) Pop image from stack - (05)-(05) Clear stack - (06)-(01) Load Palette Table - (06)-(02) Save Palette Table - (06)-(03) Display Palette Table - (06)-(04) Push Palette Table - (06)-(05) Pop Palette Table - (8) Tech. information: Program (user interface and some subroutines) written by Jih-Shin Ho. Some subroutines are borrowed from XV (2.21) and PBMPLUS (Dec. 1991). JPEG is based on the library by the Independent JPEG Group. Tiff (V3.2) reading/writing are from the Tiff library (from ftp.sgi.com). DL is based on xdl.c & Xanim260. FLI/FLC is based on the article in DDJ (Mar. 1993). MPEG is based on Berkeley mpeg_play 2.0. AVI is based on Xanim260 by Mark Podlipec. MPEG split is based on mpgsplit by Stefan Eckart. Compiled with DJGPP. You can get the whole DJGPP package from : omnigate.clarkson.edu: /pub/msdos/djgpp (9) For those who want to modify a video driver: 1. For HiColor and TrueColor, please refer to ET4000.ASM. (10) Final: This document is not well written. If you have any PROBLEMS, SUGGESTIONS, COMMENTS on this program, please send a mail to u7711501@bicmos.ee.nctu.edu.tw (140.113.11.13). (There is NO anonymous ftp on this site.) I need your suggestions to improve this program. Acknowledgments: I should like to thank the authors of XV and PBMPLUS for their permission to let me use their subroutines. Also, I thank the authors of the TIFF and JPEG libraries. Thank you DJ. Without DJGPP I can't do anything on a PC. The author would like to thank Olivier Dumas, Ben Jos Walbeehm, Bryan Woodworth and other users for their advice and suggestions. The author would like to thank NCTUCCCA for offering a place for DISP. Jih-Shin Ho u7711501@bicmos.ee.nctu.edu.tw